Apollo Server는 GraphQL API를 쉽게 만들고 운영할 수 있게 해주는 오픈소스 서버 라이브러리입니다. 원래 Apollo GraphQL 팀에서 개발했으며, Node.js 환경에서 널리 쓰입니다. 주요 목적은 GraphQL 스키마와 리졸버(데이터 가져오는 함수)를 연결해 클라이언트가 쿼리/뮤테이션/서브스크립션을 실행할 수 있는 엔드포인트를 제공하는 것입니다. 주요 특징 - 스키마·리졸버 기반: GraphQL 타입 정의(typeDefs)와 리졸버(resolvers)를 사용해 API를 구성합니다. - 다양한 프레임워크 통합: Express, Fastify 등과 미들웨어 형태로 쉽게 연동됩니다. - 확장성(페더레이션): Apollo Federation을 통해 마이크로서비스 형태로 여러 GraphQL 서브그래프를 결합해 단일 게이트웨이로 노출할 수 있습니다. - 개발툴 통합: Apollo Sandbox(또는 이전의 GraphQL Playground)로 쿼리 테스트, 스키마 탐색이 가능합니다. Apollo Studio와 연동하면 모니터링·스키마 레지스트리·퍼포먼스 추적이 가능합니다. - 데이터소스·캐싱: RESTDataSource 같은 유틸리티로 외부 API 호출을 구조화하고 내부 캐싱을 활용할 수 있습니다. - 인증·컨텍스트: 요청별 컨텍스트를 통해 인증 정보나 DB 커넥션을 전달할 수 있습니다. - 플러그인 시스템: 로깅, 에러 핸들링, 성능 측정 등 확장 포인트 제공. - 서브스크립션(실시간): 기본 제공 지원은 버전 따라 차이가 있고, 최신 버전에서는 graphql-ws 등 별도 솔루션과 결합해 구현하는 것을 권장합니다. 간단한 사용 예 (Node.js, Apollo Server v4 스타일) - 설치: npm install @apollo/server graphql express body-parser - 코드 요약: import { ApolloServer } from '@apollo/server'; import { expressMiddleware } from '@apollo/server/express4'; import express from 'express'; import bodyParser from 'body-parser'; const typeDefs = `type Query { hello: String }`; const resolvers = { Query: { hello: () => 'Hello world' } }; const server = new ApolloServer({ typeDefs, resolvers }); await server.start(); const app = express(); app.use('/graphql', bodyParser.json(), expressMiddleware(server)); app.listen(4000); 언제 쓰나 - 클라이언트가 다양한 데이터 소스(데이터베이스, REST API, 마이크로서비스)를 단일 GraphQL 엔드포인트로 통합해 사용하도록 할 때. - 여러 팀이 각각의 서브그래프를 관리하고 이를 통합해야 할 때(페더레이션). - 개발 편의성(토이 프로젝트부터 프로덕션 수준까지)과 툴링(Explorer, Studio) 이점을 얻고자 할 때. 주의할 점 - 버전별로 API와 기본 제공 기능(예: 서브스크립션, Playground)이 달라집니다. 사용 중인 버전의 문서를 확인해야 합니다. - 성능·보안(쿼리 복잡도 제어, 캐싱, 인증) 설계는 직접 신경 써야 합니다. 요약하면, Apollo Server는 GraphQL 서버 구현을 쉽게 하고 운영·확장·모니터링을 도와주는 기능을 제공하는 Node.js용 GraphQL 서버 프레임워크입니다.
